Skip to main content

广告模块

广告模块包括激活事件和深度链接 (DeepLink)，激活事件是当用户应用第一次打开时有且仅发一次的事件，深度链接是提供客户通过活动网页等形式提供 App 渠道的跳转和下载。 在深度链接技术场景中，可以直接唤起 App 并跳转至指定页面，同时根据条件判断用户跳转路径，当用户已经安装 App 时可以直接唤起 App，当用户未安装 App 时会引导用户下载 App。

info

平台版本 >=4.0 支持，产品使用文档可参考 深度链接

采集 SDK 版本 >=3.4.7

使用时注意模块版本需要与采集 SDK 版本保持一致

深度链接配置​

  1. 在顶部导航栏选择 获客分析 -> 产品配置 -> 深度链接配置，进入深度链接配置页面

  2. 找到需要配置的 iOS 应用，点击更多信息，查看当前应用的配置

  3. 点击 Universal Link 编辑按钮，获取 Team ID 并填入表单中

如何获取 Team ID

在苹果开发者网站中找到 Team ID 与 Bundle ID config_team_id

  1. 点击 复制 Link 按钮，在您的 Xcode 项目配置中打开 Associated Domains 功能，并将所复制的 Link 添加到 Associated Domains 列表中

  1. 勾选我已完成 Xcode 配置，允许 Universal Link 跳转，点击保存

模块集成​

  1. 使用 Cocoapods 安装
pod 'GrowingAnalytics/Advert'

打开终端，切换到项目目录，执行 pod install 或 pod update

  1. 在 AppDelegate.m 中导入 #import "GrowingAdvertising.h"

模块配置​

广告模块中提供了相关配置：

配置接口参数类型是否必填默认值说明
readClipboardEnabledBOOL否YES是否允许读取剪切板的应用信息
deepLinkHostNSString是nil深度链接配置地址，示例：https://n.datayi.cn
deepLinkCallbackBlock否nil监听深度链接中的地址参数
GrowingAutotrackConfiguration *configuration = [GrowingAutotrackConfiguration configurationWithProjectId:@"YourAccountId"];
configuration.dataCollectionServerHost = @"YourServerHost";
configuration.dataSourceId = @"YourDatasourceId";

// 是否允许读取剪切板的应用信息
configuration.readClipboardEnabled = YES;
// 深度链接配置地址
configuration.deepLinkHost = @"Your DeepLinkHost";
// 监听深度链接中的地址参数
configuration.deepLinkCallback = ^(NSDictionary * _Nullable params, 
                                   NSTimeInterval processTime, 
                                   NSError * _Nullable error) {
};

[GrowingAutotracker startWithConfiguration:configuration launchOptions:launchOptions];

可以通过该方法手动发送 DeepLink 事件，该接口常用于应用内部广告获客接收

配置接口参数类型是否必填默认值说明
doDeeplinkByUrlNSURL是null深度链接URL，示例：https://n.datayi.cn/k4wudMXn
[[GrowingAdvertising sharedInstance] doDeeplinkByUrl:[NSURL URLWithString:@"Your DeepLinkUrl"]
                                            callback:^(NSDictionary * _Nullable params,
                                                       NSTimeInterval processTime,
                                                       NSError * _Nullable error) {
        
}];

获取 Apple Search Ads 归因数据分析​

如您需要使用 Apple Search Ads 归因数据分析，在 SDK 初始化时打开 ASAEnabled 开关：

GrowingAutotrackConfiguration *configuration = [GrowingAutotrackConfiguration configurationWithProjectId:@"YourAccountId"];
configuration.dataCollectionServerHost = @"YourServerHost";
configuration.dataSourceId = @"YourDatasourceId";

// 打开 ASAEnabled 开关
configuration.ASAEnabled = YES;

[GrowingAutotracker startWithConfiguration:configuration launchOptions:launchOptions];

在 Target -> Build Phases -> Link Binary With Libraries，添加 iAd.framework 和 AdServices.framework，并设置 AdServices.framework status 为 Optional